home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-06 / notice15.zip / README15.TXT < prev   
Text File  |  1991-07-28  |  12KB  |  258 lines
  1.        ┌────────────────────────────────────────────────────┐
  2.        │        Notice.exe: a system noticeboard for        │
  3.        │         use in Novell NetWare (tm) Systems.        │
  4.        │               Version 1.5, July 1991               │
  5.        │    (c) 1991, David Harris, all rights reserved.    │
  6.        └────────────────────────────────────────────────────┘
  7.  
  8. ┌──────────────────────────────────────┐
  9. │ Notes about version 1.5              │
  10. └──────────────────────────────────────┘
  11.  
  12. Notice v1.5 adds a number of enhancements to previous versions of
  13. notice, in particular the following:
  14.  
  15. *  You can now specify both groups and users as message targets.
  16. *  Expired messages are shown with an 'E' in Admin mode, and can be
  17.    deleted with a single keypress. 'Unborn' messages are shown with
  18.    a '~' in the browser.
  19. *  Printing: you can now print messages while you read them. Printing
  20.    direct to NetWare queues is supported, as are PostScript printers.
  21.    Notice will remember each user's print selections from invocation
  22.    to invocation.
  23. *  Full online help: make sure you copy the file NOTICE.HLP to the
  24.    same directory as NOTICE.EXE. The online help includes a full
  25.    editor reference as well.
  26. *  Notice no longer clears the screen if there are no new notices.
  27.  
  28. NOTE: Do NOT press <Ctrl-Break> while running Notice: this will lock
  29. any machine with a Phoenix BIOS, and perhaps other types as well.
  30.  
  31.  
  32. ┌──────────────────────────────────────┐
  33. │ i:  What Notice.exe IS:              │
  34. └──────────────────────────────────────┘
  35. * Notice.exe is a programmable noticeboard for NetWare systems: it
  36. allows notices to be posted by supervisors or designated managers and
  37. to be read by individual users or NetWare user groups. Notices can be
  38. set to "come alive" on a certain date, and to "live" only for a set
  39. number of days from that date. Notices can be flagged for particular
  40. NetWare user groups, and only members of those groups will have
  41. access to them.
  42.  
  43. * Notice.exe is designed to be called from the system login script,
  44. Net$log.dat, to display new messages. It remembers the messages a
  45. user has already read, and does not bother him with them again.
  46.  
  47. * Alternate noticeboards can be set up on the same fileserver: this
  48. allows workgroups within an environment to have their own notice
  49. boards.
  50.  
  51.  
  52. ┌──────────────────────────────────────┐
  53. │ ii: What Notice.exe is NOT:          │
  54. └──────────────────────────────────────┘
  55. * Notice.exe is NOT a conferencing system: it does not employ
  56. sophisticated locking strategies, and only one user can have the
  57. ability to post messages at a time.
  58.  
  59. * Notice.exe is NOT a bulletin board system: it has no file
  60. download capabilities, and there is no threading between messages.
  61.  
  62. With these distinctions clearly in mind, you are ready to start using
  63. Notice.exe on your system.
  64.  
  65.  
  66. ┌──────────────────────────────────────┐
  67. │ Installation:                        │
  68. └──────────────────────────────────────┘
  69. To install Notice.exe, copy the files NOTICE.EXE and NOTICE.HLP to a 
  70. publicly-mapped subdirectory on your fileserver. You may rename
  71. NOTICE.EXE, or set it to eXecute-only if you wish.
  72.  
  73.  
  74. ┌──────────────────────────────────────┐
  75. │ Setting up a noticeboard:            │
  76. └──────────────────────────────────────┘
  77. Before a noticeboard can be used, it must be initialized: this can
  78. only be done by SUPERVISOR-equivalent users. 
  79.  
  80. 1: Create a directory in a public location where the notices and
  81. notice system files will be stored: internally, Notice.exe defaults
  82. to SYS:PUBLIC/NOTICES, but you can place the directory anywhere.
  83. Grant at least ROSWCD rights (RFWCD under NW386) to users who are to
  84. administer and post notices on the directory; grant ROS (RF under
  85. NW386) to all others.
  86.  
  87. 2: In the same directory as Notice.exe, create a file called
  88. NOTICE.CFG. This should be a text file consisting of one line - the
  89. name of the notice directory. You can also specify the name of the
  90. directory on the command line if you prefer, in which case you do not
  91. need to create this file. The name of the directory should be
  92. specified in NetWare format (VOL:PATH/PATH) rather than DOS format.
  93. If you are happy to accept SYS:PUBLIC/NOTICES as a default notice
  94. directory, then do not create Notice.cfg (but do make sure that the
  95. directory exists!).
  96.  
  97. 3: Type "NOTICE /I" at the DOS command prompt; if you did not create
  98. Notice.cfg at step 2, type "NOTICE /F <path> /I" instead, replacing
  99. <path> with the name of the directory you created. Notice.exe will
  100. prompt you for a new starting message number, and the name of a user
  101. record file. The user record file is the name of the file notice.exe
  102. will create in each user's SYS:MAIL directory to record the messages
  103. he/she has already read. If you are going to run multiple notice
  104. boards on your server, you will need to use a different user record
  105. name for each noticeboard. There is NO default user record name.
  106.  
  107. 4: Type "NOTICE /A" (or "NOTICE /F <path> /A") at the command prompt
  108. to enter Administrator mode. Only one user can access administrator
  109. mode for a noticeboard at any time. You can now create messages as
  110. you wish. Creating and editing messages is discussed below.
  111.  
  112. 4a:  Repeat the above steps for as many noticeboards as you wish:
  113. note that to use noticeboards other than the default system board,
  114. you must start Notice.exe with the /F switch to specify the directory
  115. path (you would normally do this from a batch file). Each noticeboard
  116. must have its own directory.
  117.  
  118. 5: Modify SYS:PUBLIC/NET$LOG.DAT either with a text editor, or by
  119. using the "Alter System Login Script" option in SYSCON; at an
  120. appropriate stage in the system login AFTER the drive holding
  121. Notice.exe has been mapped, place the command:
  122.  
  123.     "#notice /n"
  124. or  "#notice /f <path> /n" if you did not create Notice.cfg.
  125.  
  126. This modification will check for messages unread by each user when
  127. he/she logs in, and will display only new messages then exit.
  128.  
  129. ** Finished! Not that hard, really, was it! **
  130.  
  131.  
  132. ┌──────────────────────────────────────┐
  133. │ Using the noticeboard                │
  134. └──────────────────────────────────────┘
  135. Users wishing to re-read notices can run the notice program at any
  136. time simply by typing "notice" at the command prompt. Note that if
  137. they are browsing an alternate noticeboard, or if you did not create
  138. Notice.cfg or use SYS:PUBLIC/NOTICES, they will have to start
  139. Notice.exe using the /F switch to specify the directory contain the
  140. notice system files they want to use.
  141.  
  142.  
  143. ┌──────────────────────────────────────┐
  144. │ Creating and manipulating notices    │
  145. └──────────────────────────────────────┘
  146. A noticeboard is not excessively useful without notices, so
  147. Notice.exe provides tools internally for creating and modifying
  148. notices and bulletins: to use these tools, you must start Notice.exe
  149. in Administrator mode, by typing "NOTICE /A"  (or "NOTICE /F <path>
  150. /A" if you are not using Notice.cfg or SYS:PUBLIC/NOTICES).
  151.  
  152. Only users with at least RWOCD rights in the notice directory can use
  153. Administrator mode, and Notice.exe allows only one user to be in
  154. Administrator mode for a noticeboard at any time. If another user is
  155. in administrator mode when you attempt to run "NOTICE /A", you will
  156. receive a message suggesting that you try again later. Users logging
  157. in should not be affected by a user in Administrator mode.
  158.  
  159. Users who inadvertently leave Notice.exe running in Administrator
  160. mode when they go for a cup of coffee will not cause too much
  161. inconvenience, since Notice.exe will terminate normally after two
  162. minutes without a keypress.
  163.  
  164. In administrator mode, there are some options available which are
  165. not available in user mode:  add a message (press <Ins>) delete a
  166. message (press <Del>), modify a message (press <F3>) and Purge
  167. expired messages (press <F4>. Users who are not SUPERVISOR-equiv-
  168. alent can only modify or delete notices which they themselves have
  169. posted. SUPERVISOR-equivalent users can affect any message.
  170.  
  171. When you choose to add a notice, it will be given the next message
  172. number, and you will be placed in the message editing screen: enter
  173. the following information:
  174.  
  175.    * Description: a brief précis of the contents of the message.
  176.    * A group list: a list of groups whose members are permitted to
  177.      read the message, separated by commas. Entering nothing here is
  178.      considered the same as entering EVERYONE.
  179.    * A starting date (default is today's date) in the format DD/MM/YY
  180.      if you are using a European country setting in your CONFIG.SYS,
  181.      or MM/DD/YY if you have no country setting, or use US date
  182.      conventions. Note that the virgule (/) is the only valid date
  183.      delimiter.
  184.    * A lifetime: the number of days after the starting date for which
  185.      the notice is valid. A value of 0 is taken to mean that the
  186.      notice is immortal (lucky thing).
  187.  
  188. While editing the notice, commands a bit like WordStar are available,
  189. and a full search-and-replace facility is implemented. To see the
  190. available block and quick commands, type either ^K or ^Q and wait
  191. half a second: a small window will open listing the valid keys. When
  192. you have finished editing the message to your satisfaction, press
  193. <Ctrl-Enter>. To abandon editing the message, press <Esc>. For those
  194. of you who use Pegasus Mail (my NetWare mailer) the editing commands
  195. are identical to the editing commands in Pmail (funny that, it's the
  196. same editor unit...). The following table details the available
  197. editing commands:
  198.  
  199.   <Left>, <Right>, <Up>, <Down>  Move a character at a time
  200.   <^D>, <^S>, <^E>, <^X>         Move a character at a time
  201.   <^Left>, <^Right>              Move a word at a time
  202.   <^A>, <^F>                     Move a word at a time
  203.   <Home>, <End>                  Start/End of line
  204.   <^Q,S>, <^Q,D>                 Start/End of line
  205.   <PgUp>, <PgDn>                 Move a screen at a time
  206.   <^R>, <^C>                     Move a screen at a time
  207.   <^PgUp>, <^PgDn>               Top/End of message
  208.   <^Q,R>, <^Q,C>                 Top/End of message
  209.   <^Z>, <^W>                     Scroll Up/Down one line.
  210.   <^End>                         Delete to end of line
  211.   <^T>                           Delete word right of cursor 
  212.   <^Y>                           Delete line
  213.   <^N>                           Insert blank line at cursor
  214.   <^Q,F>                         Find string, 
  215.   <^Q,A>                         Find and Replace string
  216.   <^L>                           Repeat last search
  217.   <^K,B>                         Mark block
  218.   <^K,H>                         Finish marking block
  219.   <^K,C>, <^K,V>                 Copy/cut block to buffer
  220.   <^K,I>                         Insert buffer
  221.   <^K,M>                         Comment block out
  222.   <^K,R>, <^K,W>                 Read/Write block to/from file
  223.   <^Q,M>                         Set right margin for wordwrap
  224.   <^Q,G>                         Goto specific line in message
  225.   <Tab>, <Shift-Tab>             Indent/Outdent marked block
  226.   <^V>, <Alt-D>, <F12>           Form digraph
  227.   <^P>                           Insert next character 
  228.  
  229.  
  230. About Notice.exe:
  231.  
  232. Notice.exe is free software. It is written using Turbo-C++ v1.01
  233. (Borland International Inc), and the Novell C Interface Libraries. 
  234. Feel free to distribute it, but do not sell it, either on its own, 
  235. or as part of any other package.
  236.  
  237. The author is grateful for any financial support offered by users -
  238. any donation is guaranteed to go towards either hardware or software
  239. for the development of further such programs.
  240.  
  241. If you have queries or bug reports, please email david@otago.ac.nz
  242. via Internet, or dave_h at BIX (Byte Information Exchange). From
  243. CompuServe, I can be mailed as internet:david@otago.ac.nz.
  244.  
  245. Send slowmail, donations, razoos, valuable antiques etc. to:
  246.  
  247.       David Harris,
  248.       P.O. Box 5451,
  249.       Dunedin
  250.       New Zealand.
  251.  
  252. The postal address is guaranteed to be good until the beginning of
  253. 1993, the email addresses likely also.
  254.  
  255. - David Harris -
  256.  July 28th 1991
  257.  
  258.